home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / NTH_OCC.HDR < prev    next >
Text File  |  1994-04-25  |  988b  |  36 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _Nth_Occr( cInStr, cInChar, nNthOccr ) --> nInteger
  8.  
  9. PARAMETERS:
  10.  
  11. cInStr   = string to be searched
  12. cInChar  = string looking for
  13. nNthOccr = 'nth' occurance of cInChar.
  14.  
  15. SHORT:
  16.  
  17. Return the "nth" occurance of one string in another string (delimited).
  18.  
  19. DESCRIPTION:
  20.  
  21. _Nth_Occr() returns the position of "nNthOccr" occurance of string "cInChar"
  22. in string "cInStr" or zero if cInChar string is not in cInStr at all or the
  23. specified occurance is more than the number of occurances.
  24.  
  25. NOTE:
  26.  
  27. See also: _Extract()
  28.  
  29. EXAMPLE:
  30.  
  31. ? _Nth_Occr('AB/CD/EF/GH','/',2) // Returns 6
  32. ? _Nth_Occr('AB/CD/EF/GH','/',3) // Returns 9
  33. ? _Nth_Occr('AB/CD/EF/GH','/',4) // Returns 0
  34.  
  35. ******************************************************************************/
  36.